@@include("_includes/header.html", {"title": "EvImSync"})

<div class="wrapper">
<div class="content">
    <h2>EvImSync</h2>

        <p>EvImSync is a small tool to synchronize
        <a href="https://evernote.com/">Evernote</a> notebooks with a
        <a href="https://mail.google.com/mail/">Gmail</a> account.
        Notes in Evernote are uploaded to your Gmail account as emails, and
        emails in Gmail are imported to Evernote notebooks as notes.
        </p>
        <img src="./img/evimsync/evimsync-overview.png" alt="overview" width="344" height="159">
        <p>
        EvImSync requires .NET Framework 4. You can get this via Windows
        update or directly from <a href="https://www.microsoft.com/en-us/download/details.aspx?id=17851">here</a>.
        </p>

        <h3 id="details">Details: how it works</h3>
        <p>
        EvImSync uses the Evernote script engine <code>ENScript.exe</code>
        to import and export notes. These notes are parsed and then compared
        to emails in your Gmail account using the IMAP protocol. This requires
        that you have enabled IMAP in your Gmail settings:
        </p>
        <img src="./img/evimsync/Gmail-IMAP.png" alt="Gmail-IMAP" width="444" height="66">
        <p>
        You can sync one notebook with one folder in a Gmail account. EvImSync
        allows you to sync as many notebooks and Gmail folders as you like.
        </p>

        <h3 id="limitations">Limitations</h3>
        <p>
        Due to limitations both in the IMAP protocol, the Evernote scripting
        engine and the available documentation, the synchronization is not
        perfect. Some things simply can't be done by EvImSync.
        </p>
        <ul>
            <li>Notes in Evernote are not deleted: if you delete an email
            in Gmail, that deletion is not reflected in Evernote. ENScript
            doesn't have a command to delete a specific note. Instead, EvImSync
            uploads the note from Evernote again to Gmail. That means that
            if you want to delete a note, you must do that in Evernote, not
            in your Gmail account. Notes that are deleted in Evernote get
            moved to the folder "evernote trash" in your Gmail account
            from where you can remove them permanently if you like.</li>
            <li>Tag changes in Gmail are not reflected in Evernote: Again,
            ENScript doesn't have a command to do that. However, if you have
            a new email that's not already synced the Evernote you can use
            Gmail to add the tags you like. New emails are properly imported
            to Evernote with all the Gmail tags you have set.
            Synching tags in the other direction works ok: If you change
            tags in Evernote, those changes are properly reflected in your
            Gmail account.</li>
            <li>Source URLs are not synched: Source URLs from Evernote are
            not stored in Gmail, but of course left as is in the Evernote notes.</li>
            <li>Ink notes: Evernote Ink notes are not shown in Gmail. The
            format of those notes is not documented, so I can't convert them
            to images or something like that which would properly be shown
            in an email. Instead, such notes are converted to an email
            attachment. Synching those works, but as mentioned you won't
            be able to actually see them in Gmail.</li>
        </ul>

        <h3 id="installation">Installation</h3>
        <p>EvImSync does not require installation. It can be run from any
        place. Just double-click on the file to run it.</p>
        <p>By default, EvImSync stores its configuration in the <code>%APPDATA%</code>
        folder. However if you want to use EvImSync on an USB-stick, rename
        the exe file to <code>EvImSyncPortable.exe</code>: this will force
        EvImSync to store its configuration in the same directory as it was
        started from.</p>

        <h3 id="configuration">Configuration</h3>
        <p>
        EvImSync needs to know which Gmail folder it has to sync with which
        of your notebooks in Evernote. To do that, you have to enter this
        information in the configuration dialog. You can get to that dialog
        via the <code>File-&gt;Configuration</code> menu.
        </p>
        <img src="./img/evimsync/evimsync-configuration.png" alt="configuration" width="473" height="404">
        <ul>
            <li><code>Path to ENScript.exe</code>: in case EvImSync can not
            determine that path automatically, you have to set it yourself.
            That tool should be in the folder where you've installed Evernote.</li>
            <li><code>Evernote Notebook</code>: the name of the notebook
            you want to sync.</li>
            <li><code>Server</code>: the domain name of the Gmail imap server.
            Usually that's <code>imap.gmail.com</code>.</li>
            <li><code>Username</code>/<code>Password</code>: your Gmail username and
            password.</li>
            <li><code>Base Folder</code>: the IMAP folder name where you want
            your notes to be put under. EvImSync requires that all notes
            be stored in a subfolder. I usually use <em>Notes</em> or the
            name of the Evernote notebook for that name.</li>
        </ul>
        <p>
        After you've set that information, click on the <em>Set Pair</em>
        button to store the Gmail/Notebook pair. You can configure as many
        pairs as you like.
        </p>

        <h3 id="synching">Synching</h3>
        <p>
        If you've set up at least one sync pair, just click on the <em>Start Sync</em>
        button to start the synchronization. Depending on how many notes/emails
        you have, this might take a while though.
        </p>
        <img src="./img/evimsync/evimsync-main.png" alt="main" width="537" height="180">

        <h3 id="reports">Report problems</h3>
        <p>
        In case you encounter a bug or some other problem, please file an
        issue in the <a href="https://sourceforge.net/p/evimsync/tickets/">issue tracker</a>.
        If EvImSync has problems with the encoding of emails, please save
        the email as an <code>eml</code> and attach it to the issue. Otherwise
        filing the issue is useless since I won't be able to reproduce the
        problem and therefore won't be able to fix it.
        </p>

        <h3 id="download">Download</h3>
        <p>
        EvImSync is open source (<a href="https://www.gnu.org/licenses/gpl-3.0.html">GNU GPL v3</a>). You can get the source code from
        the SourceForge <a href="https://sourceforge.net/projects/evimsync/">project page</a>.
        </p>
        <p>
        If you just want the compiled application, get it from the
        <a href="https://sourceforge.net/projects/evimsync/files/">download page</a>.
        </p>
</div>
</div>

@@include("_includes/footer.html")
